package cn.edu.qzuie.artist.module.td.service.teacher;

import java.util.*;

import cn.edu.qzuie.artist.module.td.controller.admin.teacher.vo.*;
import cn.edu.qzuie.artist.module.td.controller.app.student.vo.AppStudentAuthLoginRepVo;
import cn.edu.qzuie.artist.module.td.controller.app.student.vo.AppStudentAuthLoginRespVo;
import cn.edu.qzuie.artist.module.td.controller.app.teacher.vo.AppTeacherAuthLoginRepVo;
import cn.edu.qzuie.artist.module.td.controller.app.teacher.vo.AppTeacherAuthLoginRespVo;
import cn.edu.qzuie.artist.module.td.dal.dataobject.teacher.TeacherDO;
import cn.edu.qzuie.artist.framework.common.pojo.PageResult;
import cn.edu.qzuie.artist.framework.common.pojo.PageParam;

import javax.validation.Valid;

/**
 * 教师 Service 接口
 *
 * @author 泉信管理员
 */
public interface TeacherService {


    /**
     * 工号 + 密码登录
     *
     * @param reqVO 登录信息
     * @return 登录结果
     */
    AppTeacherAuthLoginRepVo login(@Valid AppTeacherAuthLoginRespVo reqVO);


    /**
     * 刷新访问令牌
     *
     * @param refreshToken 刷新令牌
     * @return 登录结果
     */
    AppTeacherAuthLoginRepVo refreshToken(String refreshToken);

    /**
     * 创建教师
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createTeacher(@Valid TeacherSaveReqVO createReqVO);

    /**
     * 更新教师
     *
     * @param updateReqVO 更新信息
     */
    void updateTeacher(@Valid TeacherSaveReqVO updateReqVO);

    /**
     * 删除教师
     *
     * @param id 编号
     */
    void deleteTeacher(Long id);

    /**
     * 获得教师
     *
     * @param id 编号
     * @return 教师
     */
    TeacherDO getTeacher(Long id);

    /**
     * 获得教师分页
     *
     * @param pageReqVO 分页查询
     * @return 教师分页
     */
    PageResult<TeacherDO> getTeacherPage(TeacherPageReqVO pageReqVO);

    /**
     * 批量插入教师数据
     *
     * @param teacherList 待插入的教师信息列表
     * @throws Exception 插入过程中可能出现的异常，如数据库连接异常、数据格式错误等
     */
    TeacherExcelRespVo batchInsertTeachers(List<TeacherExcelDataInputVO> teacherList, boolean isupdateSupport);
}